home *** CD-ROM | disk | FTP | other *** search
/ Aminet 21 / Aminet 21 (1997)(GTI - Schatztruhe)[!][Oct 1997].iso / Aminet / util / sys / TitleCD_v300.lha / TitleCD.doc < prev   
Text File  |  1997-08-06  |  4KB  |  130 lines
  1. Short:     CD replacement (wildcards, window title)
  2. Author:    soenke@vapor.com (Sönke Tesch)
  3. Uploader:  soenke@vapor.com
  4. Type:      util/dir
  5. Replaces:  util/dir/TitleCD.lha
  6. Keywords:  CD Modula-2
  7. Interface: Shell CLI
  8.  
  9. TitleCD is a replacement for the original CD shell command. I wasn`t that
  10. happy with the way the Shell usually displays the current directory because
  11. it simply resulted in annoying long prompts of 1/2 to 2/3 times of the window
  12. width. On the other hand the window title is unused - the solution could not
  13. be easier (btw: my replacement was in fact smaller than C=s` original..:).
  14.  
  15. The whole thing has been extended with wildcard support, an argument that
  16. speeds up changing between the current and the last directory ("cd lastdir"
  17. instead of "cd sys:bla/blo/ble/bli") and writing/reading the directory to
  18. or from a file.
  19.  
  20.  
  21. Installation
  22. ============
  23.  
  24.   Only 3 steps - couldn`t be easier:
  25.  
  26.   a) copy TitleCD to c:cd
  27.   b) add the line
  28.  
  29.        resident cd remove
  30.  
  31.      to your s:user-startup
  32.   c) reboot
  33.  
  34.   That`s it :)
  35.  
  36.   If you want you can make TitleCD resident but this is IMHO not necessary
  37.   unless you`re using a floppy-disc-based system. You will not notice the
  38.   difference with harddisks.
  39.  
  40.  
  41. How to use
  42. ==========
  43.  
  44.   TitleCD DIR,TO/K,FROM/K,LASTDIR/S,NOTITLE/S
  45.  
  46.   DIR
  47.     New current directory - same as in the original but TitleCD also
  48.     supports wildcards e.g. "cd sys:#?/pri#?" will most likely cd to
  49.     "sys:devs/printers". The first matching directory is choosed.
  50.  
  51.   TO/K
  52.     If given TitleCD writes the name of the current directory to this
  53.     file. No newline is appended! To print the name into the shell
  54.     window use "cd to console:".
  55.  
  56.   FROM/K
  57.     If given TitleCD reads the name of the new current directory from
  58.     this file.
  59.  
  60.   LASTDIR/S
  61.     If set TitleCD switches back to the last current directory.
  62.  
  63.     Example:
  64.  
  65.       1.ram:env/system/EggPaint> cd sys:graphics/EggPaint
  66.       1.sys:graphics/EggPaint> cd lastdir
  67.       1.ram:env/system/EggPaint>
  68.  
  69.   NOTITLE/S
  70.     If set the title of the Shell window is not changed.
  71.  
  72.  
  73. Environment Variables
  74. =====================
  75.  
  76.   TitleCD uses sets/uses two local variables:
  77.  
  78.     LastDir    - the name of the last current directory
  79.     CurrentDir - the name of the current current directory
  80.  
  81.   LastDir is actually used for the LASTDIR argument.
  82.  
  83.   You can use set and get to access these (see AmigaDOS manual).
  84.  
  85.  
  86. Copyright
  87. =========
  88.  
  89.   TitleCD, TitleCD.readme and TitleCD.doc:
  90.    Copyright 1993-1997 by Sönke Tesch
  91.    All Rights Reserved.
  92.  
  93.   You may re-distribute the archive as long as no file is removed or
  94.   changed.
  95.   Find has to be distributed for FREE, any other kind of distribution
  96.   without my written permission is not allowed. However, this is not
  97.   the case for any AmiNet-CD. Others please feel free to ask.
  98.   I do not give any guarantee for the quality and usefulness of Find
  99.   nor that it works as described or fits particular needs.
  100.  
  101.  
  102. Contact
  103. =======
  104.  
  105.   Comments, suggestions, bug-reports and Hey-I-use-it!-mails are
  106.   always welcome! Just write to <soenke@vapor.com>.
  107.  
  108.  
  109. Those finer details..
  110. =====================
  111.  
  112.   TitleCD is written using Cyclone Modula-2 by Marcel Timmermans.
  113.   The source is available on request, just ask.
  114.  
  115.  
  116. History
  117. =======
  118.  
  119.    Actually none written :) The first version was born somewhere back in
  120.    1993, the current version 3 contains actually 100% new code.
  121.  
  122.  
  123. Have fun,
  124.   soenke (06-Aug-97)
  125.  
  126. --
  127. Amiga Translators Organization * Main & German Admin, Ex-Human Listserver
  128. ato    : ato-admin-de@ato.vapor.com & ato-admin@ato.vapor.com
  129. private: soenke@vapor.com
  130.